Release 10.1A: OpenEdge Development:
ADM Reference

disableWidget

Disables the object or objects identified in the namelist.

For SmartDataFields, it runs the disableField function. disableField is not a generic SmartDataField function, therefore this API is only supported for SmartDataFields that have disableField defined. If a field in the list is not found, or a SmartDataField without disableField is included in the list, disableWidget returns FALSE.

Location: visual.p

Parameters:

INPUT namelist AS CHARACTER

The name of one or more objects, separated by commas.

Returns: LOGICAL

Notes:

Data fields are removed from the EnabledFields and EnabledHandles properties to ensure that once the field is disabled by the API, it remains disabled,
Local fields are removed from the EnabledObjFldsToDisable property when the property is set to a field list. When the EnabledObjFldsToDisable property is set to (All), the disableWidget function sets this property to the value of the EnabledObjFlds property without the field being disabled. This action ensures that once a field is disabled by the API, it remains disabled. When the EnabledObjFldsToDisable property is set to (None), it is not changed.
Examples:

The following illustrates the use of this method in 4GL code for use with a graphical user interface:

IF widgetValue("Browse.Terms":U) NE "":U THEN disableWidget("Self.Discount":U).

The following illustrates the use of this method in DHTML code for use with a Web browser:

if (logic.widgetValue(‘orderfullo.browse.terms’)!=’’) logic.disableWidget(‘customerviewv.discount’);